home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / aga / aastarter12.lha / AAStarter / AAStarter.doc < prev    next >
Encoding:
Text File  |  1995-01-22  |  9.3 KB  |  307 lines
  1.  
  2.  
  3.                              AAStarter
  4.                              ---------
  5.  
  6.                        Version 1.2 (22.01.95)
  7.  
  8.                       © 1994,95 Stefan Scherer
  9.  
  10.  
  11. WHAT DOES AASTARTER?
  12. --------------------
  13.  
  14. The  program  AAStarter  modifies  the "Amiga Early Startup Control".  With
  15. this  change  you  can  use the boot menu with monitors which can't display
  16. 15kHz  screen  modes.   The  boot menu is then opened with a DblNTSC screen
  17. mode.
  18.  
  19.  
  20. SYSTEM REQUIREMENTS
  21. -------------------
  22.  
  23. This  program  needs  the  AA  chipset.   It also needs the kickstart 39 or
  24. higher.   This  program  has  been  tested with various kickstarts (39.106,
  25. 40.62 and 40.70).
  26.  
  27.  
  28. COPYRIGHT
  29. ---------
  30.  
  31. This  software  is  subject  to  the  "Standard Amiga FD-Software Copyright
  32. Note".   It  is  FREEWARE as defined in paragraph 4a.  For more information
  33. please read "AFD-COPYRIGHT" (Version 1 or higher).
  34.  
  35.  
  36. WARNING
  37. -------
  38.  
  39. With  this  program  you  can destroy your monitor!  If you don't know what
  40. this program is for, you'd better don't use this program!
  41.  
  42. Don't  use  this  software,  if  you have no problems with the "Amiga Early
  43. Startup  Control".  And don't use this program, if you have a monitor which
  44. can sync only upto 15kHz!
  45.  
  46.  
  47. UPDATE FROM V1.0
  48. ----------------
  49.  
  50. If  you  are  using  AAStarter  V1.0  already,  please  remove  it from the
  51. "s:user-startup" and delete the executable.  After this, you have to switch
  52. off  your  computer  to  remove  AAStarter  out  of  your  memory.  See the
  53. INSTALLATION part to install the new version of AAStarter.
  54.  
  55.  
  56. UPDATE FROM V1.1
  57. ----------------
  58.  
  59. If  you are using AAStarter V1.1, then please write down your old tool type
  60. values  and delete the AAStarter from your "WBStartup" drawer.  After this,
  61. you  have  to  switch  off  your  computer  to remove AAStarter out of your
  62. memory.  See the INSTALLATION part to install the new version of AAStarter.
  63.  
  64.  
  65. INSTALLATION
  66. ------------
  67.  
  68. It  is  very simple to install AAStarter.  Just drag the AAStarter into the
  69. drawer "WBStartup" on your system partition.
  70.  
  71. After  the  next  reset  you  can  use the "Amiga Early Startup Control" by
  72. pressing both mouse buttons.
  73.  
  74.  
  75. USAGE
  76. -----
  77.  
  78. You  can  start  AAStarter from a shell or from the workbench.  The easiest
  79. way is to use AAStarter from your "WBStartup" drawer.
  80.  
  81. After  installation  you  can  use  the  boot  menu with monitors which can
  82. display the DblNTSC screen mode.  Simply press both mouse buttons.
  83.  
  84. If  you  want bypass the AAStarter for one boot, then press all three mouse
  85. buttons, if you have a three button mouse.
  86.  
  87.  
  88. CONFIGURATION
  89. -------------
  90.  
  91. If  your  monitor  doesn't work with the default DblNTSC screen mode or you
  92. want  another  screenmode,  then  use  the  program "MonEd" to find out the
  93. monitor  settings.  You can get "MonEd" from AmiNet ("gfx/aga/MonEd3a.lha")
  94. or any mailbox.
  95.  
  96. You can change most of the monitor settings in the tool types of AAStarter.
  97. The following tool types are recognized:
  98.  
  99.         MODEID
  100.  
  101.         HBSTRT
  102.         HBSTOP
  103.         VBSTRT
  104.         VBSTOP
  105.         TOTROWS
  106.         TOTCLKS
  107.  
  108.         VGAONLY
  109.         
  110.         DCLIPMINX
  111.         DCLIPMINY
  112.         DCLIPMAXX
  113.         DCLIPMAXY
  114.  
  115.         MINCOL
  116.         MINROW
  117.         BEAMCON0
  118.  
  119. I  haven't  tested  the last three tool types, because I have no values for
  120. them.   By default, all tool types are commented out.  This means, that the
  121. internal values are used.
  122.  
  123. With  "MonEd" you get values for HBSTRT, HBSTOP, VBSTRT,VBSTOP, TOTROWS and
  124. TOTCLKS.   All  values are hex values.  You must give the hex values with a
  125. "0x" at the beginning.  Otherwise this values are read as decimal values.
  126.  
  127. Example: If you want the Super72 screen mode, then you edit the tool types
  128. as follows
  129.  
  130.         MODEID=0x99004
  131.         HBSTRT=0x01
  132.         HBSTOP=0x21
  133.         VBSTRT=0x00
  134.         VBSTOP=0xbd1
  135.         TOTROWS=0x1a9
  136.         TOTCLKS=0x79
  137.  
  138. Another  example:   If  you want the Super72 screen mode with VGAonly, then
  139. edit the tool types as follows
  140.  
  141.         MODEID=0x99000
  142.         HBSTRT=0x01
  143.         HBSTOP=0x21
  144.         VBSTRT=0x00
  145.         VBSTOP=0xf73
  146.         TOTROWS=0x1c1
  147.         TOTCLKS=0x71
  148.         VGAONLY
  149.         DCLIPMINX=-24
  150.         DCLIPMINY=-16
  151.         DCLIPMAXX=616
  152.         DCLIPMAXY=184
  153.  
  154. With  MODEID  you  can change the DisplayID for the screen.  There are only
  155. three  values  which  should be used.  By default, the DisplayID 0x99000 is
  156. used.  But if you can't see the bottom gadgets, try 0x99004 instead.
  157.  
  158.         0x99000 - DBLNTSC HighRes
  159.         0x99004 - DBLNTSC HighRes NoFlicker
  160.         0x99005 - DBLNTSC HighRes Laced
  161.  
  162. Don't  use  other  values, e.g.  0x69024 for the Super72 screen mode.  This
  163. doesn't  work!   The  AAStarter  only inserts the DblNTSC monitor.  You can
  164. specify all monitor settings to get the right screen mode.
  165.  
  166. If  you  want  the  VGAonly  feature  then simply add the tool type VGAONLY
  167. without  any  parameters.   This tool type does the same as the V40 VGAonly
  168. program.
  169.  
  170. The  four DCLIP....  tool types are for adjusting the screen position.  The
  171. default values are
  172.  
  173.         DCLIPMINX=0
  174.         DCLIPMINY=0
  175.         DCLIPMAXX=640
  176.         DCLIPMAXY=200
  177.  
  178. Note  that  MAXX  - MINX should be at least 640 and MAXY - MINY sould be at
  179. least  200.   (See  also  the  second example above.) You may give negative
  180. values  for DCLIPMINX and DCLIPMINY to shift the screen into the upper left
  181. corner  of  your  monitor.   I  don't know if you can move the screen every
  182. pixel, but it should work in steps of 8 pixel.
  183.  
  184. Every  time  you  start AAStarter, the new values are given to the resident
  185. module  of  AAStarter.   You needn't switch off your computer to update the
  186. new  values.   Just change the tool types and start AAStarter again.  After
  187. the next reset you will get the boot menu with these values.
  188.  
  189. If  you  use  AAStarter from a shell, AAStarter doesn't read the tool types
  190. from  the  icon.   You  can  specify  values  with  arguments.   Write  the
  191. parameters exactly like the tool types above.
  192.  
  193.  
  194. HINT FOR VGAONLY USERS
  195. ----------------------
  196.  
  197. If  you  need  VGAonly  to run the workbench on your monitor, then you must
  198. modify  the  tool  types.   To set the right values, please start MonEd and
  199. read out the monitor settings.  VGAonly should already run, because you get
  200. different  values  if  VGAonly is running or not.  You can get "MonEd" from
  201. AmiNet  ("gfx/aga/MonEd3a.lha")  or  any  mailbox.  In addition, insert the
  202. tool  type  VGAONLY.   After  this,  your boot menu should start with about
  203. 31kHz.
  204.  
  205.  
  206. KNOWN BUGS
  207. ----------
  208.  
  209. The following 'bugs' are known and I can't fix them:
  210.  
  211. 1.   If  you  are  in  the  boot menu and hit any key, then the screen mode
  212. switches  to  an  undefined  mode.   This  is a feature of the boot menu to
  213. toggle  between PAL and NTSC mode (not DBLPAL or DBLNTSC!).  Just don't hit
  214. any key...
  215.  
  216. 2.   The  AAStarter  is  not able to change the screen mode for the alerts.
  217. The  problem is that the alerts are not displayed on screens.  So I have no
  218. screen  mode  to  change.  The best solution would be to turn off the alert
  219. function, but alerts disappear automatically after a couple of seconds.  If
  220. you  really  have  system  crashes,  then  use  some other tools to get the
  221. information  after  the  next boot.  The best thing is to use Enforcer (and
  222. SegTracker)  which  suppresses  most  alerts  and give you more information
  223. BEFORE a system crash happens...
  224.  
  225.  
  226. 3.   With  AAStarter  you  can't  switch the screen mode for games and demo
  227. programs.   The problem is similar to the alert problem above.  Games can't
  228. be supported for many reasons:
  229.  
  230.         - timing problems (blitter dma<-> display dma)
  231.         - copper lists must be changed to set some registers in every frame
  232.         - the AA chipset can't run in two different modes at the same time
  233.  
  234. I  know  some very old games from 1988/89 which open a real screen.  Funny,
  235. but  this  games can be started from workbench an with a small screen patch
  236. you  can play them on any screen mode you like.  But most of the games must
  237. boot  from  a  disk  drive and uses only some copper list hacks.  So if you
  238. really  want to play games or look at some of these demos, then use your TV
  239. or a small monitor...
  240.  
  241.  
  242. AUTHOR
  243. ------
  244.  
  245. If this program makes your boot menu work, please give me a note.  You have
  246. saved  a  lot  of  money  with  this  program,  because  you needn't buy an
  247. expensive  scan doubler.  If you have any questions, suggestions, ...  then
  248. contact me.
  249.  
  250.         Stefan Scherer
  251.         Abt-Wolf-Str. 17
  252.         96215 Lichtenfels
  253.         Germany
  254.  
  255.         phone: +49 (0) 9571/6203
  256.  
  257.         EMail: scherer@cris.fh-coburg.de
  258.  
  259.  
  260. HISTORY
  261. -------
  262.  
  263. 0.0 (04.06.94)
  264.  
  265.         thought about it... sorry folks, forgot it for a while :-)
  266.  
  267. 1.0 (27.12.94)
  268.  
  269.         made it work with the DblNTSC screen mode
  270.  
  271.     (03.01.95)
  272.  
  273.         first release in the AmiNet
  274.  
  275. 1.1 (06.01.95)
  276.  
  277.         made it more configurable for users
  278.         (thanks to Norman Iscove who was the first one suggesting this)
  279.  
  280.         + can start from the workbench
  281.         + user can specify his monitor settings (e.g. taken from MonEd)
  282.         + user can specify the ModeID (e.g. change 0x99000 to 0x99004)
  283.  
  284.     (09.01.95)
  285.  
  286.         put it into the AmiNet
  287.  
  288. 1.2 (13.01.95)
  289.  
  290.         made some additions to the doc file
  291.  
  292.     (22.01.95)
  293.  
  294.         compiled AAStarter for 68000 CPU's
  295.         (thanks to Magnus Holmgren for this hint)
  296.  
  297.         fixed some minor bugs
  298.  
  299.         added some new tool types to move the screen
  300.  
  301.         added a tool type to switch on the VGAonly feature
  302.         (thanks to Jan Skypala for this hint)
  303.  
  304.     (23.01.95)
  305.  
  306.         another AmiNet release
  307.